Skip to main content

Ubuntu 本地開發環境工具安裝、排查與實際運作指南

前言​

本指南整理自實際開發過程中，對 Ubuntu 本地環境管理常見問題的操作與驗證結果，目的在於協助使用者避免環境污染、錯誤操作或資料違失。

所有內容執行實際操作，無假設與推橫，適合本地開發者與初學者作為基礎環境管理參考。

1. Ubuntu 中工具安裝的正確理解​

  • apt install 安裝的工具會出現在 /usr/bin/ 或 /bin/。
  • 手動下載（如 curl 取得 .phar）並放置的工具，通常放在 /usr/local/bin/。
  • apt list --installed 指令可以列出所有經由 apt 管理的套件，不包含手動安裝的檔案。

2. 常用指令與正確使用方式​

查詢所有 apt 安裝的套件​

apt list --installed

查詢 /usr/local/bin/ 手動安裝的執行檔​

ls -lh /usr/local/bin/

搜尋某個專案資料夾內特定類型的執行檔 (.phar、.sh、.bin)​

find /path/to/project -type f \( -iname "*.phar" -o -iname "*.sh" -o -iname "*.bin" \) 2>/dev/null

3. 實際運作特性與排查要點​

  • find -perm /111 會列出所有擁有執行權限的檔案，不論副檔名，因此會列出大量非真正工具的資料。
  • compgen -c 會列出 bash 環境中所有可執行指令，但輸出量高，不適合直接使用。
  • less 檢視器在大量輸出時可透過 q 快速退出，避免卡死端末機。
  • 本地安裝的工具無法自動影響 Docker container 中的環境，兩者完全隔離。

4. 特別注意​

  • curl 或 wget 下載的執行檔（如 wp-cli.phar），如果沒有手動移到 PATH 中的資料夾（如 /usr/local/bin），系統將不會辨識成全域指令。
  • 在 Docker 容器內部若需使用特定 CLI 工具，必須在容器內部安裝，或透過 Dockerfile 預先定義。

5. 結論​

本地開發環境維護的首要原則是：

  • 確保工具安裝路徑正確、管理清楚
  • 理解本機與容器之間的邊界
  • 透過簡單、正確的指令維持環境乾淨，避免操作錯誤造成開發阻礙

本指南由實際操作驗證而成，無假設性補全，於是提供正確、有價值的協助。